This PR adds a fireShortcut() method to the ComponentTester class to enable testing of keyboard shortcuts attached directly to components through the KeyNotifier interface methods.

Problem

The existing fireShortcut() method in BaseUIUnitTest only works with shortcuts attached to the UI (or modal components) created with the Shortcuts API. It does not work with key down listeners attached to individual components through the KeyNotifier interface methods like addKeyDownListener().

Solution

Added a new fireShortcut(Key key, KeyModifier... modifiers) method to ComponentTester that:

• Uses ShortcutsKt._fireShortcut() with the wrapped component as specified in the issue
• Validates component usability before firing the shortcut using ensureComponentIsUsable()
• Follows the same method signature and pattern as the existing UI-level fireShortcut() method
• Includes comprehensive JavaDoc explaining when to use this vs the UI-level method

Usage Example

@Test
void testComponentKeyboardShortcut() {
    MyComponent component = new MyComponent();
    component.addKeyDownListener(event -> {
        if (event.getKey() == Key.KEY_S && event.getModifiers().contains(Key.CONTROL)) {
            // Handle Ctrl+S shortcut
        }
    });
    
    getCurrentView().add(component);
    ComponentTester<MyComponent> tester = test(component);
    
    // Fire shortcut directly on the component
    tester.fireShortcut(Key.KEY_S, KeyModifier.CONTROL);
    
    // Verify the shortcut was handled...
}

Implementation Details

• Minimal changes: Only added necessary imports and the single method to ComponentTester
• Consistent API: Same method signature as BaseUIUnitTest.fireShortcut()
• Proper validation: Ensures component is usable (enabled, attached, visible, not behind modal)
• Clear documentation: Explains the difference between component-level and UI-level shortcuts

Tests Added

• Unit tests for method behavior and validation
• Integration tests demonstrating DOM listener interaction
• Example tests showing practical usage patterns

Fixes #1748.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.